home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / util / shell / axsh_1_3_demo.lha / InstallDisk.lha / man / xpr.man < prev   
Text File  |  1993-03-15  |  3KB  |  116 lines
  1.  
  2.  
  3. XPR            USER COMMANDS             20-May-1992
  4.  
  5.  
  6. NAME
  7.     XPR - Use Amiga external protocols for upload and download
  8.  
  9. SYNOPSIS
  10.     XPR send protocol filename [file2 ..]
  11.     XPR receive protocol [filename]
  12.     XPR list
  13.  
  14. DESCRIPTION
  15.  
  16.     XPR  uses the normal Amiga external protocol libraries to do
  17.     the  file  transfer.   XPR  might not work without a special
  18.     serial  handler,  because  it  needs  a  real  raw  mode for
  19.     communication.   e.g.  original AUX:  in ks1.3 will eat NULs
  20.     and do LF to LFCR translations even if in RAW mode.  So, you
  21.     just better use it with AXAUX: only..
  22.  
  23.     Different  types of options for different kinds of protocols
  24.     are    supported   by   an   external   configuration   file
  25.     AXsh:etc/xprotos.tab.  This file contains protocol names and
  26.     corresponding  library  names  and  option settings for that
  27.     entry.   Several  protocols  may  use  the same library with
  28.     different option settings.
  29.  
  30.     An example entry in a xprotos.tab file:
  31.  
  32.     a) "zmodem"
  33.     b) Library: xprzmodem.library
  34.     c) Descrip: Binary/No overwrite/No delete/No paths
  35.     d) Options: TN ON B16 F0 E10 AN DN KY SN RN PAXsh:spool/upload
  36.  
  37.     a) is the protocol name, the 'handle'
  38.     b) is the library to use for the protocol
  39.     c) is the (optional) description of the protocol to display
  40.        before the transfer
  41.     d) is the option settings for the protocol
  42.  
  43.     All  other  entries  must  follow a).  c) must always become
  44.     before  either b) or d) to be detected.  The spelling of the
  45.     keywords is case-sensitive.
  46.  
  47. OPTIONS
  48.  
  49.     XPR send protocol filename
  50.  
  51.         This command will send a/the specified file/-s using
  52.         the  defined  protocol.   An  error  message will be
  53.         printed  if there is not an appropriate entry in the
  54.         tab-file.
  55.  
  56.     XPR receive protocol filename
  57.  
  58.         This  will  receive  one  or  more  files  using the
  59.         defined  protocol.   A missing entry in the tab file
  60.         will  generate an error.  If you want to upload more
  61.         than  one  file,  the  protocol  must  support batch
  62.         transfers  and  the  filename  is  left  out  of the
  63.         command.
  64.  
  65.     XPR list
  66.  
  67.         This will list the available protocols.
  68.  
  69.  
  70. BEWARE!
  71.     XPR  receive  is  a  security risk.  It is not wise to allow
  72.     overwrite   AND   uploading   to   any  directory.   If  the
  73.     library/protocol   does   not   provide  a  way  to  disable
  74.     overwrite,  you  must restrict either the upload pathname or
  75.     the use of the command.
  76.  
  77.     An  example  of  an  unsafe protocol is xmodem.  It does not
  78.     check  (or  provide any options to disable) overwrite and it
  79.     does not provide any option to change the upload directory.
  80.  
  81.     However,  if  the  protocol  allows you to specify an upload
  82.     directory, you can use an empty directory specification.  If
  83.     the  options  string  ends up with a "P" (upper case p), XPR
  84.     will  append  the  home directory of the user to the string,
  85.     and the upload will go to the home directory.
  86.  
  87. EXAMPLE
  88.  
  89.     > XPR s zmodem file1 file2
  90.  
  91.     Will  send  first  file1  and  then file2 using the "zmodem"
  92.     entry in the AXsh:etc/xprotos.tab.
  93.  
  94.     > xpr l
  95.     XPR Version 1.0 17-May-92
  96.     Available protocols:
  97.     "zmodem"
  98.         Binary/No overwrite/No delete/No paths
  99.     "zmodem-window8k"
  100.         Binary/No overwrite/8k window/No delete/No paths
  101.     "ymodem"
  102.         Batch/Chop/CRC16/1K blocks
  103.     "ymodem-g"
  104.         Batch/Chop/CRC16/1K blocks/No Acks or retries on errors
  105.     "ymodem-a"
  106.         Batch/Chop/2K blocks/No CRC checking or Acks or retries
  107.  
  108. FILES
  109.     AXsh:bin/XPR        The program
  110.     AXsh:etc/xprotos.tab    The settings for protocols
  111.     AXsh:etc/adm/xpr.log    A log file
  112.  
  113. SEE ALSO
  114.     ffe
  115.  
  116.